home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 47.7z / BS1 part 47 / Soundtracker v2.3 (1989)(Spreadpoint - CCS - Defjam).7z / Soundtracker v2.3 (1989)(Spreadpoint - CCS - Defjam).adf / Text / Soundtracker.DOC < prev   
Text File  |  1989-04-25  |  13KB  |  348 lines
  1.  
  2. Note: This Soundtracker is based on the MasterSoundtracker V1.0
  3.       by TIP/PROPHETS and mainly on Soundtracker V2.2 by Unknown/D.O.C
  4.  
  5. Soundtracker V2.3 - A Quick Clarification.
  6. ------------------------------------------
  7.  
  8. Update         : April 1989.
  9.  
  10. Update done by : MnemoTroN.
  11.  
  12. Instructions   : Tracer and Unknown of D.O.C / Based on J.C.-Instructions
  13.          MnemoTroN.
  14. -------------------------------------------------------------------------
  15.  
  16. Modifications by D.O.C:
  17. -----------------------
  18.  
  19.         A sample sort function
  20.         Corrected 'DisplayPattern' routine
  21.         Corrected preset-editor
  22.         Improved record function
  23.         Extended keymap (Sonix style)
  24.         Pattern play function
  25.         Delete Song function in the dos menu
  26.         Improved ANALYZER
  27.         Pattern changing during play
  28.         Pattern break command
  29.         Position jump command
  30.         Sample zero function 
  31.         New playroutine for use in demos/intros/games
  32.         Improved graphics (colors,styling,font)
  33.         Nice scrolling
  34.         Animated mousepointer
  35.         Directory Sort function
  36.         New Colors for the Analyzer
  37.         Extension to 31 Instruments
  38.  
  39. Modifications by MnemoTroN:
  40. ---------------------------
  41.  
  42.         Scroll-Line removed
  43.         Animated Mousepointer removed
  44.         Extended DOS-Window
  45.         Key-Help-Page
  46.         Nice 'Sure?'-Requester
  47.         Reinsertion of Length-,Repeat- and RepLen-Gadgets
  48.         Lowpass-Filter is switched off
  49.         Load Module
  50.         Save Sample
  51.         Format Disk
  52.         Clear Song
  53.         and some small details that must not be mentioned here
  54.  
  55. The Song.
  56. ---------
  57.  
  58. Any piece of music written with Soundtracker 2.3 is build up from patterns.
  59. Soundtracker  holds  a  table  with information about the sequence in which
  60. these parts must be played.  With 'Position' you determine your position in
  61. the  table.   With  'Pattern'  you  define  what  pattern  to  play at that
  62. position.  'Length' defines the total size of the table.  The full sequence
  63. of Patterns is the Song.
  64.  
  65.  
  66. The Keys.
  67. ---------
  68.  
  69. The  original  (V1.8)  version  of  the  Soundtracker  had a German keymap.
  70. Version  2.3  supports a standard USA keymap and this ensures compatibility
  71. with  ALL  Amigas.  The keyboard has been extended, try typing on the whole
  72. key-rows.  The keys on your Amiga have been grouped to represent the layout
  73. of  a  two- octave piano-keyboard.  You can "shift" the keyboard one octave
  74. up  or down with the aid of the F1 and F2 keys, thus incrementing the range
  75. of the keyboard to three octaves.
  76.  
  77. The Functions.
  78. --------------
  79.  
  80. The  Soundtracker  V2.3  offers  many  functions  to  the  user to make the
  81. development   of   music  as  easily  as  possible.   The  Play,  Stop  and
  82. Edit-Functions  should  be  self-explaining.  Record allows you to record a
  83. pattern  in real-time, but it is recommended that you better use the normal
  84. Edit-Mode.   'Clear  Song' will erase all song- and sample-data from memory
  85. after  a security-check.  'Use PSET' will load the selected sample into the
  86. current  slot  and  'Disk  Op'  switches  to  the  DOS-Menu.   Here you can
  87. Load/Save/Delete  Songs  and  Modules.   If you are into ripping music, you
  88. will  find  the  'Save Sample' option useful.  Just select the sample to be
  89. saved  (you  may  change  the  disk  and  name  by  simply  clicking on the
  90. 'sample-name'-line)  and  it  is  done!   'Format  disk' will do just that.
  91. After  a  security-check you are asked for the volume-number.  Only numbers
  92. will  be  accepted.   The  formatting will begin just after you entered the
  93. number,  so  please  be  careful.   If  you  enter  '00', Soundtracker will
  94. automagically create a song- and a module-directory.
  95.  
  96. While editing:
  97. --------------
  98.                Cursor-keys move cursor.
  99.        shift + Cursor-keys move cursor fast.
  100.          alt + Cursor-keys move cursor fastest.
  101.                F6  - Set cursor to first line of pattern.
  102.                F7  - Set cursor to 16th line of pattern.
  103.                F8  - Set cursor to 32th line of pattern.
  104.                F9  - Set cursor to 48th line of pattern.
  105.                F10 - Set cursor to last line of pattern.
  106.                DEL - Delete note under cursor.
  107.        shift + F3  - Cut track of current pattern and copy into a buffer.
  108.        shift + F4  - Copy track of current pattern into a buffer.
  109.        shift + F5  - Copy buffer to track of current pattern.
  110.          alt + F3  - Cut the whole pattern and copy into a buffer.
  111.          alt + F4  - Copy pattern into a buffer.
  112.          alt + F5  - Copy buffer to current pattern.
  113.  
  114. As  a  new feature, these commands can be reviewed at any time (except when
  115. using the DOS-Menu) by pressing the HELP-key!
  116.  
  117. A  small  word  about  the  +/-  gadgets:   pressing  the  left  AND  right
  118. mousebutton will in-/decrease the value faster !!
  119.  
  120. Sample sort function:
  121. ---------------------
  122. Unknown  inserted  a special sort function in the load-song routine, so you
  123. needn't be a D.J.  anymore.
  124.  
  125. Only  the  D.O.C-Soundtrackers  V2.1 to V2.3 will load ALL Samples from the
  126. Disk 'ST-01', then from 'ST-02', then from 'ST-03' and so on.
  127.  
  128. Sample zero function:
  129. ---------------------
  130. While  editing you're able to set the sample to the value zero (0!).  Press
  131. both mousebuttons at the position of the samplegadgets (plus, minus = +,-).
  132. Now  you  can  edit  the  pattern with the sample 0 to prevent difficulties
  133. according to the volume (Frog's idea) !!!
  134.  
  135.  
  136. Correct 'DisplayPattern' routine:
  137. ---------------------------------
  138. The  'MasterSoundtracker  V1.0'  and  the  'D.O.C-Soundtracker V2.0' had an
  139. incorrect 'DisplayPattern' routine !!!  The highest bit of the command- and
  140. infobyte  had  been  deleted  on  screen,  but not in the memory !!!!!!!!!!
  141. Unknown discovered this bug and removed it.
  142.  
  143. Example:           Entered -  E-2 C2FF   <=- Correct !
  144.          Printed out later -  E-2 427F   <=- Wrong instrument and infobyte!
  145.            Still in memory -  E-2 C2FF   <=- Correct !
  146.  
  147.  
  148. Instruments.
  149. ------------
  150. You  can use up to thirtyone different instruments in one music-piece.  All
  151. instruments  are  listed  in the preset-list.  The volume is always 64, but
  152. you  can  change  it  to  each value between 0 and 64.  To change the other
  153. values  of  each  instrument  you have to load the preset-editor or use the
  154. gadgets  in the program (this is only for small changes.  use the preset-ed
  155. otherwise!).   With the PresetEd you can change the whole preset-list.  TIP
  156. improved  the  preset-editor:  some values (Length, Repeat and RepLen) have
  157. to  be  entered  in  hexadecimal  !!!   Now you can use samples up to $8000
  158. (=32768) bytes !!!!  (Press right mouse-button to quit).
  159.  
  160. Unknown corrected the preset-editor:  It got a nice bug ! (Not TIP's fault)
  161.  
  162. Example: You've an  instrument called 'HeavySynth' in your preset-list, now
  163.          you want  to INSERT an  instrument  with  the name 'Heavy'  in it.
  164.          The preset-editor searches  for the word 'HEAVY' in the list, find
  165.          the name 'HEAVYsynth' and  DELETES it to insert the name 'Heavy' !
  166.  
  167. Of course Unknown discoverd and removed this bug, too.
  168.  
  169.  
  170. Notes:
  171. ------
  172.                C#1  0 3 C 2 3
  173.                /     /  |  \|
  174.               /     /   |   Info
  175.              /     /  Command
  176.             /    Inst#
  177.          Note to
  178.          be played.
  179.  
  180.  
  181.  
  182. Note:     This is simply the note that is played with that particular
  183. -----     instrument.
  184.  
  185. Inst#:    This is the number of the instrument that is used to play that
  186. ------    note.  When the  instrument number  is zero, the last selected
  187.           instrument will be used.
  188.  
  189. Command:  This number tells Soundtracker what special functions shall be
  190. --------  performed while playing the note.
  191.  
  192. These functions are as follows:
  193.  
  194.      0 - Normal play or arpeggio.
  195.      1 - Portamento up.
  196.      2 - Portamento down.
  197.      A - Volume slide.
  198.      B - Position jump.
  199.      C - Set volume.
  200.      D - Pattern break.
  201.      E - Set filter on/off.
  202.      F - Set speed.
  203.  
  204. Info:      This byte contains the additional information for the commands.
  205. -----     
  206.  
  207. Arpeggio:  Arpeggio is used for simulating accords. This is done by rapidly
  208. ---------  changing the  notes while  playing an instrument.  Arepggios are
  209.            selected  whenever the  info byte  has a  non-zero value  and no
  210.            other command is selected.
  211.            When arpeggios  are used,  Soundtracker looks  five times during
  212.            the play  of one note,  at the information contained in the info
  213.            byte. Each nibble  (4 bits) in this byte  defines how many notes
  214.            Soundtracker must add to the the note currently played.  In each
  215.            of the  five passes  Soundtracker  does  the following  with the
  216.            information in the info byte:
  217.        
  218.        0 - Play the current note (immediately).
  219.  
  220.            1 - Add the first nibble to the current note.
  221.  
  222.            2 - Add the second nibble to the current note.
  223.  
  224.            3 - Play the current note.
  225.  
  226.            4 - Add the first nibble to the current note.
  227.  
  228.            5 - Add the second nibble to the current note.
  229.  
  230.  
  231. Portamento:  Portamento is used for  'sliding' the frequency of the sample.
  232. -----------  If  portamento  is in use, the  information  contained in  the
  233.              the info byte will be added to (or subtracted from) the period
  234.              of the note playing in each of the five passes.
  235.  
  236.    Example:  D#2 3208  Slides down $08
  237.              --- 0208  Slides down $08
  238.              --- 0108  Slides up $08
  239.              --- 0210  Slides down $10 (=16)
  240.              etc.
  241.  
  242.    
  243. Volume slide: This function  uses the same  parameters as Portamento except
  244. ------------- for that it changes the volume.
  245.  
  246. Position jump:
  247. --------------
  248.          The position jump command will  do the same like the pattern break
  249.          command,  but the info byte  gives the playroutine  the no. of the
  250.          position.
  251.  
  252. Example: E-2 3B04 - Break the pattern and jump to position 4
  253.          --- 0000
  254.          --- 0B06 - Break the pattern and jump to position 6
  255.  
  256.  
  257. Volume:  One of  the enhancements  that the  V2.3 version  provides  is the
  258. -------  ability to change the volume at any time during play.
  259.          When command $0C (=12) is selected, the volume is set to the value
  260.          contained in  the info byte.  The volume will remain at this level
  261.          until the next SAMPLE is played. At this time, the volume is reset
  262.          to the default volume level of that sample.
  263.  
  264. Example: C#1 1C22 - Set volume to $22 (=34) and use instrument # 1 to
  265.                     play the C#1 note.
  266.          D-2 0000 - Use instrument # 1 to play the D-2 note.
  267.                     (Volume level remains at $22 (=34))
  268.          B-1 1000 - Use instrument # 1 to play the B-1 note and
  269.                     set volume to default value for that
  270.                     instrument.
  271.  
  272. Pattern break:
  273. --------------
  274.          Pattern break is used to create shorter patterns than 64 notes.
  275.          The note with the $0D command will be played and after that the
  276.          next pattern in the position-table will be played.
  277.  
  278. Example: A#3 1D00 - At this point the pattern interrupts.
  279.          --- 0D00 - same.
  280.          C-1 0D30 - same.
  281.  
  282.  
  283. Filter:  This Soundtracker version allows you to turn the lo-pass filter
  284. -------  on/off.
  285.  
  286. Example: G#2 1E01 - Turns the filter and the power-led off.
  287.          --- 0000
  288.          E-1 1E00 - Turns the filter and the power-led on.
  289.  
  290. Warning  to  all  Amiga 1000 owners (like Unknown and Esteban):  Don't play
  291. with  the  power-led  because  some A500 and A2000 owners will not be happy
  292. when they hear your song.
  293.  
  294.  
  295. Speed:   This function allows changing the speed during play.
  296. ------   You can only enter a speed from $01 to $0F.
  297.          Setting the info byte to zero doesn't effect anything.
  298.          The normal speed is 6.
  299.  
  300. Example: D-2 4F04 - Set speed to 4
  301.          --- 0000
  302.          E-1 0F00 - Nothing happens to speed.
  303.          --- 0FC3 - Set speed to 3
  304.          G-2 2F06 - Set normal speed
  305.  
  306.      For your convenience the speed will now be set to 6 everytime you
  307.      load a song/module or clear the song.
  308.  
  309. The Playroutine.
  310. ----------------
  311. The  Playroutine on the Soundtracker disk is for using your music in demos,
  312. intros,  games etc.  It was written using the Seka-assembler and the source
  313. of  the  routine  can  directly  be incorporated in your demo/intro source.
  314. When  you are finished writing your music using D.O.C-Soundtracker, save it
  315. to   Disk.   Use  the  function  'SAVE  MODULE'.   You  will  find  in  the
  316. 'MODULES'-DIR  a  file, which contains all songdata and samples.  Load with
  317. SEKA  the  source  of the playroutine and enter the size of saved module at
  318. the label 'mt_data'.  Assemble.  Now load the saved module to 'mt_data'.
  319.  
  320. How to play a song:
  321. -------------------
  322. At the beginning of your program, call the 'mt_init' routine.
  323. Each vertical blank jump to the 'mt_music' routine.
  324. To stop the song jump to the 'mt_end' routine.
  325.  
  326. ---------------------------------------------------------------------------
  327.  
  328. ADDITIONAL INFORMATION:
  329.  
  330. - This Soundtracker-Version consists of ONE disk which should include the
  331.   following files:
  332.     - Soundtracker (V2.3)
  333.     - Songplayer (V1.4)
  334.     - SongPrinter (V1.1d)
  335.     - PresetEd,PED!,PED!! (V1.1 by The BallCrackers)
  336.     - PresetEd +
  337.     - PLST (this is my (MnemoTroN) PLST and please do not ask for the
  338.       samples because that are 13 disks!
  339.     - MuzakRipper (by NorthStar)
  340.     - Soundtracker Instruments Ripper (by Beastie Boys)
  341.     - 'mod.echoing' and 'mod.my way to the stars' in the module-directory
  342.       (my favourites!)
  343.     - all DOC files in the 'Text'-Directory
  344.     - the 31 Instruments Replay-Routine (also in 'Text')
  345.  
  346. ----------------------------------------------------------------------------
  347.  
  348.